1.Configs
1.1. General
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| Tags |
string[] |
[] |
액터의 Tag를 설정합니다. |
2. Components
<Dummy ...> 블록으로 아무 동작하지 않는 Transform 정보만 가진 컴포넌트를 생성할 수 있습니다.
2.1. Mesh
2.1.1. 속성
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| Asset |
string |
|
로드할 3D 모델(Static Mesh)의 에셋 이름입니다. |
2.2. Spline
2.2.1 속성
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| Asset |
string |
|
로드할 Spline의 에셋 이름입니다. |
3. Actions
3.1. Set
Set 액션은 액터나 컴포넌트에 등록된 특정 변수(Property)의 값을 원하는 시점에 즉시 변경할 때 사용합니다.
<Set Name="변수명" Value="변경할값" />
3.1.1. 속성
| 속성 키 |
타입 |
설명 |
| Name |
string |
코드에 등록된 변수의 고유 이름 (예: MaxSpeed) |
| Value |
variant |
변경하고 싶은 값 (해당 변수의 타입에 맞춰 작성) |
3.2. Event
커스텀 이벤트를 호출할 때 사용합니다.
<Event Name = "커스텀 이벤트명"/>
3.2.1. 속성
| 속성 키 |
타입 |
설명 |
| Name |
string |
커스텀 이벤트 이름 |
3.3. SpawnActor
SpawnActor는 현재 액터의 위치를 기준으로 새로운 액터를 생성하는 액션입니다.
<SpawnActor Name="액터 이름" ... />
3.3.1. 속성
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| Name |
string |
|
생성할 액터의 에셋 이름(또는 팩토리 키)입니다. |
| Loc |
float3 |
(0 0 0) |
부모(현재 투사체)로부터의 상대적인 생성 위치입니다. |
| Rot |
float3 |
(0 0 0) |
부모로부터의 상대적인 생성 회전값입니다. |
| Scale |
float3 |
(1 1 1) |
생성될 액터의 크기 배율입니다. |
3.4. Destroy
Destroy는 현재 액터를 파괴하는 액션입니다.
<Destroy/>
3.5. Activate
Activate는 비활성화되어 있는 특정 컴포넌트를 활성화 상태로 전환하는 액션입니다. 파티클의 방출을 시작하거나 메시를 화면에 나타낼 때 사용합니다.
<Activate Target="컴포넌트_이름" Child="false" />
3.5.1. 속성
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| Target |
string |
필수 |
활성화할 대상 컴포넌트의 고유 이름(Name)입니다. |
| Child |
bool |
false |
true일 경우, 해당 컴포넌트뿐만 아니라 모든 자식 컴포넌트도 함께 활성화합니다. |
3.6. Deactivate
Deactivate는 활성화된 컴포넌트를 비활성화 상태로 전환하는 액션입니다. 투사체의 외형을 숨기거나 특정 효과를 중단할 때 사용합니다.
<Deactivate Target="컴포넌트_이름" Child="false" />
3.6.1. 속성
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| Target |
string |
필수 |
비활성화할 대상 컴포넌트의 고유 이름(Name)입니다. |
| Child |
bool |
false |
true일 경우, 해당 컴포넌트뿐만 아니라 모든 자식 컴포넌트도 함께 비활성화합니다. |
4. Events
4.1. OnSpawn
액터가 월드에 생성되는 즉시 호출됩니다. 주로 발사 이펙트 재생이나 초기 사운드 출력 등 생성 직후의 연출을 담당합니다.
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| - |
- |
- |
별도의 속성이 없으며, 생성 시점에 1회 발생합니다. |
4.2. OnDestroy
액터가 파괴되거나 수명(LifeSpan)이 종료되어 월드에서 제거되기 직전에 호출됩니다.
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| - |
- |
- |
별도의 속성이 없으며, 제거 직전에 1회 발생합니다. |
4.3. OnTime
액터 생성 시점으로부터 설정된 특정 시간이 경과했을 때 호출됩니다.
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| Time |
float |
0.0 |
지연 시간. 생성 후 몇 초 뒤에 이벤트를 실행할지 결정합니다. |
4.4. OnActivate
특정 컴포넌트가 활성화(Activate)되는 시점에 호출됩니다.
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| Target |
string |
필수 |
상태 변화를 감시할 대상 컴포넌트의 이름입니다. |
4.5. OnDeactivate
특정 컴포넌트가 비활성화(Deactivate)되는 시점에 호출됩니다.
| 속성 키 (Key) |
타입 |
기본값 |
설명 |
| Target |
string |
필수 |
상태 변화를 감시할 대상 컴포넌트의 이름입니다. |